Using and Configuring Features Version 3.4

Configuring and Monitoring Thin Server Function

This chapter describes how to use the Thin Server Function (TSF) configuration and operating commands and includes the following sections:

"Accessing the TSF Configuration Environment"
"TSF Configuration Commands"
"Accessing the TSF Monitoring Environment"
"TSF Monitoring Commands"
"TSF Dynamic Reconfiguration Support"

Accessing the TSF Configuration Environment

Use the following procedure to access the TSF configuration process.

At the OPCON prompt, enter talk 6. (For more detail on this command, refer to "The OPCON Process and Commands" in Access Integration Services Software User's Guide.) For example:
```
    * talk 6
    Config>
 
```
After you enter the talk 6 command, the CONFIG prompt (Config>) displays on the terminal. If the prompt does not appear when you first enter configuration, press Return again.
At the CONFIG prompt, enter the feature tsf command to get to the Thin server config> prompt.

TSF Configuration Commands

To configure TSF, enter the commands at the Thin server config> prompt.

Table 62. TSF Configuration Command Summary

Command Function
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Add Adds master file server--Remote File System (RFS) or Network File System (NFS).
Delete Deletes master file server (RFS or NFS).
List Lists the thin server configuration.
Modify Modifies master file server (RFS or NFS).
Set Sets the thin server parameters.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Function
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Add	Adds master file server--Remote File System (RFS) or Network File System (NFS).
Delete	Deletes master file server (RFS or NFS).
List	Lists the thin server configuration.
Modify	Modifies master file server (RFS or NFS).
Set	Sets the thin server parameters.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

Add

Use the add command to add a master file server configuration.

If you select nfs as the master-file-server type, the Thin Server will use NFS to communicate with the master file server and synchronize files and NSs can communicate with the Thin Server using TFTP or NFS. If you select rfs as the master-server type, then the Thin Server will use RFS to communicate with the master file server and synchronize files and NSs can communicate with the Thin Server using TFTP or RFS.

Syntax:

add master-file-server: nfs-s390
: nfs-nt
: nfs-aix
: nfs-other
: rfs-as400

nfs-s390

Used when the TSF is connected to a S/390(R).

File Server IP address

Specifies the IP address of the master file server.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Secondary File Server IP address

Specifies the IP address of a backup master file server. See File Cache Updates for details. See the set selection command for a description of how this parameter is used.

Note:

This cannot be set to 0.0.0.0 if the set selection command specifies either secondary or automatic.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Master Server Refresh Retry Limit

Specifies the number of times that the TSF will retry before declaring a master file server as unreachable.

Range: 1 to 20

Default Value: 10

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added. Additional subdirectories may be specified if the TSF needs to cache files that are not in the default directories.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

nfs-nt

Used when the TSF is connected to Windows NT.

File Server IP address

Specifies the IP address of the master file server.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Secondary File Server IP address

Specifies the IP address of a backup master file server. See File Cache Updates for details. See the set selection command for a description of how this parameter is used.

Note:

This cannot be set to 0.0.0.0 if the set selection command specifies either secondary or automatic.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Master Server Refresh Retry Limit

Specifies the number of times that the TSF will retry before declaring a master file server as unreachable.

Range: 1 to 20

Default Value: 10

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp max retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

nfs-aix

Used when the TSF is connected to AIX(R).

File Server IP address

Specifies the IP address of the master file server.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Secondary File Server IP address

Specifies the IP address of a backup master file server. See File Cache Updates for details. See the set selection command for a description of how this parameter is used.

Note:

This cannot be set to 0.0.0.0 if the set selection command specifies either secondary or automatic.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Master Server Refresh Retry Limit

Specifies the number of times that the TSF will retry before declaring a master file server as unreachable.

Range: 1 to 20

Default Value: 10

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

nfs-other

Used when you want to manually designate all of the subdirectories.

File Server IP address

Specifies the IP address of the master file server.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Secondary File Server IP address

Specifies the IP address of a backup master file server. See File Cache Updates for details. See the set selection command for a description of how this parameter is used.

Note:

This cannot be set to 0.0.0.0 if the set selection command specifies either secondary or automatic.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Master Server Refresh Retry Limit

Specifies the number of times that the TSF will retry before declaring a master file server as unreachable.

Range: 1 to 20

Default Value: 10

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

rfs-as400

Used when the TSF is connected to an AS/400.

File Server IP address

Specifies the IP address of the master file server.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Secondary File Server IP address

Specifies the IP address of a backup master file server. See File Cache Updates for details. See the set selection command for a description of how this parameter is used.

Note:

This cannot be set to 0.0.0.0 if the set selection command specifies either secondary or automatic.

Valid Values: any valid IP address

Default Value: 0.0.0.0

Master Server Refresh Retry Limit

Specifies the number of times that the TSF will retry before declaring a master file server as unreachable.

Range: 1 to 20

Default Value: 10

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

pre-load file name

Specifies the name and path of the pre-load file.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: /QIBM/ProdData/OS400/NetStationRmtController/LoadList.file

Example: For NFS

Thin server config> add master-file-server nfs-nt
 File Server IP address [0.0.0.0]? 10.22.55.94
 Secondary File Server IP address [0.0.0.0]? 10.22.55.96
 
 Master Server Refresh Retry Limit (1-20) [10]?
 
 TFTP Packet Timeout in seconds (5 - 10) ][5]?
 
 TFTP Max Retry Limit (1 - 10) [1]?
 
 TFTP Max Segment Size in bytes (valid values are 512, 1024, 2048, 4096, 8192) [8192]?
 
Default Include Directories:
 
    Include Directory List Follows:
 
    Include
      all
    Subdirs?   Directory Names
    --------   -----------------------------------
       N       /netstation/prodbase
       Y       /netstation/prodbase/mods
       Y       /netstation/prodbase/nls
       Y       /netstation/prodbase/fonts
       Y       /netstation/prodbase/java
       Y       /netstation/prodbase/keyboards
       Y       /netstation/prodbase/proms
       Y       /netstation/prodbase/X11
       Y       /netstation/prodbase/configs
       Y       /netstation/prodbase/SysDef
       Y       /netstation/prodbase/zoneinfo
 
   Do you want additional Include Subdirectories (Y)es (N)o [N]? y
 
Include Subdirectory [   ]? /netstation/prodbase/another
Include all subdirectories under this directory (Y)es or (N)o [N]?
 
Do you want additional Include Subdirectories (Y)es (N)o [N]?

Example: For RFS

Thin server config> add master-file-server rfs
 File Server IP address [0.0.0.0]? 192.9.225.21
 Secondary File Server IP address [0.0.0.0]? 192.9.225.20
 Master Server Refresh Retry Limit (1-20) [10]?
 TFTP Packet Timeout in seconds (5-10) [5]?
 TFTP Max Retry Limit (1-10) [1]?
 TFTP Max Segment Size in bytes (valid values are 512, 1024, 2048, 4096, 8192) ][8192]?
 
 Pre-Load File name
 [/QIBM/ProdData/OS400/NetStationRmtController/LoadList.file]?

Delete

Use the delete command to remove a master file server configuration.

Syntax:

delete master-file-server: nfs
: rfs

nfs: Used when any of the NFS master file servers is configured.
rfs: Used when the TSF is configured for the RFS master file server.

List

Use the list command to display the TSF configuration.

Syntax:

list all

Example: For NFS

Thin server config> list all
 
Thin Server Feature configuration:
 
     Mode:                         ENABLED
     Master File Server Selection: PRIMARY
     Interval to refresh cache in day(s): 1
     Time of day (military time) to refresh cache: 0100
     Megabytes used for Thin Server RAM cache: 16
     Use Hard File: YES
 
 
Master Thin Server list:
     Server IP Address: 192.9.221.21
     Secondary Server IP Address: 192.9.225.20
     Server Protocol: NFS
 
     Master Server Refresh Retry Limit value: 10
     TFTP Packet Timeout value: 5
     TFTP Maximum Retry Limit value: 6
     TFTP Maximum Segment Size value: 512
 
     Initial directories setup for server type: NFS-AIX
 
 NFS Include Directory List follows:
 
     Include
       all
     subdirs?    Directory Names
     --------    -----------------------------------------
 
        N        /usr/netstation
        Y        /usr/netstation/mods
        Y        /usr/netstation/nls
        Y        /usr/netstation/fonts
        Y        /usr/netstation/java
        Y        /usr/netstation/keyboards
        Y        /usr/netstation/proms
        Y        /usr/netstation/X11
        Y        /usr/netstation/configs
        Y        /usr/netstation/SysDef
        Y        /usr/netstation/zoneinfo

Example: For RFS

Thin server config> list all
 
Thin Server Feature configuration:
 
     Mode:                         DISCONNECTED
     Master File Server Selection: PRIMARY
     Interval to refresh cache in day(s): 1
     Time of day (military time) to refresh cache: 0100
     Megabytes used for Thin Server RAM cache: 16
     Use Hard File: YES
 
 
Master Thin Server list:
     Server IP Address: 192.9.221.21
     Secondary Server IP Address: 192.9.225.20
     Server Protocol: RFS
 
     Master Server Refresh Retry Limit value: 10
     TFTP Packet Timeout value: 5
     TFTP Maximum Retry Limit value: 1
     TFTP Maximum Segment Size value: 8192
 
 Protocol RFS List:
     Pre-load File:  /QIBM/ProdData/OS400/NetStationRmtcontroller/Loadlist.file

Modify

Use the modify command to modify a master file server configuration.

Syntax:

modify master-file-server: nfs
: rfs

nfs: Used when one of the NFS master file servers has been configured.
rfs: Used when the TSF is configured for the RFS master file server.

Example: For NFS

Thin server config> modify master-file-server nfs
File Server IP address [1.1.1.1]?
Secondary File Server IP address [1.1.1.2]?
 
Master Server Refresh Retry Limit (1 - 20) [10]?
 
TFTP Packet timeout in seconds (5 - 10) [5]?
 
TFTP Max retry limit value (1 - 10) [1]?
 
TFTP Max Segment Size in bytes (valid values are 512, 1024, 2048, 4096, 8192) [8192]?
Include directory /netstation/prodbase, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [N]?
Include directory /netstation/prodbase/mods, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/nls, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/fonts, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/java, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/keyboards, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/proms, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/X11, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/configs, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/SysDef, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
Include directory /netstation/prodbase/zoneinfo, (Y)es or (N)o [Y]?
        Include all subdirectories under this directory (Y)es or (N)o [Y]?
 
Do you want additional Include Subdirectories (Y)es (N)o [N]?
Thin server config>

Example: For RFS

Thin server config> modify master-file-server rfs
File Server IP address [192.9.225.21]? 192.9.225.23
Secondary File Server IP address [192.9.225.20]? 192.9.225.22
Master Server Refresh Retry Limit (1-20) [10]? 8
TFTP Packet Timeout in seconds (5-10) [5]? 7
TFTP Max Retry Limit (1-10) [1]? 15
TFTP Max Segment Size in bytes (valid values are 512, 1024, 2048, 4096, 8192) [8192]? 4096
 
 Pre-Load File name [/QIBM/ProdData/OS400/NetStationRmtController/LoadList.file]?

Set

Use the set command to set TSF configuration parameters.

Syntax:

set: mode
: selection
: interval-pre-load-list
: time-to-refresh-pre-load-list
: memory-cache
: hard-file

mode

Specifies the mode of the TSF.

Valid Values:

enable: Specifies that the TSF is fully functional and will serve cached files to Network Stations.
disable: Specifies that the TSF is not active and will not respond to any Network Stations. Network Stations should be configured to communicate directly to the server.
passthru: Passthru mode is only valid when using RFS. Passthru allows the Network Station to contact the TSF, but always gets files from the master file server.
disconnected: Specifies that the TSF is functional and will serve cached files to Network Stations. However, traffic to the master file server is minimized. See Protocols Used to Communicate with the Network Stations for details.

Default Value: disable

selection

Specifies whether the TSF will contact the file server IP address or the secondary file server IP address for the refresh of the TSF cache.

Valid Values:

primary: Specifies that the TSF only uses the IP address in the file server IP address when trying to refresh the cache. The secondary file server IP address is ignored.
secondary: Specifies that the TSF uses only the IP address in the secondary file server IP address when trying to refresh the cache. The file server IP address is ignored.
automatic: Specifies that the TSF will try to contact the IP address specified in the file server IP address. If it is unsuccessful after the configured number of retries, then the TSF will try to contact the IP address specified in the secondary file server IP address. See File Cache Updates for details.

Default Value: primary

interval-pre-load-list

Specifies the interval (in days) at which to refresh the pre-load list in cache.

Valid Values: 00 - 365

Default Value: 01

time-to-refresh-pre-load-list

Specifies the time of day (24-hour format) at which to refresh the cached files.

Valid Values: 0001 - 2400

Default Value: 0100

memory-cache

Specifies the amount of memory in megabytes for Thin Server RAM cache. When using a hard file, this value should be chosen so as to balance the performance of TSF with other functions in the IBM 2212. When not using a hard file, this value should be large enough to hold all cached files. For more information, see "Configuration Recommendations".

Valid Values: 8 - 64 Megabytes

Default Value: 16

hard-file

Specifies whether to use the hard file.

Valid Values: yes or no

Default Value: yes

Example:

Thin server config> set mode passthru
This server feature (TSF) is passthru
Thin server config> set interval-pre-load-list
Interval to refresh the Pre-Load list in days (00-365) [01]? 1
Thin server config> set time-to-refresh-pre-load-list
Time of day to refresh cache in military time (0001-2400) [0100] 0800
Thin server config> set memory-cache
Amount of memory in megabytes for Thin Server RAM cache (8-64MB) [8]
Thin server config> set hard-file
Use the Hard File  (Y)ex N(o) [Y]? yes

Accessing the TSF Monitoring Environment

Use the following procedure to access the TSF monitoring commands. This process gives you access to the TSF monitoring process.

At the OPCON prompt, enter talk 5. (For more detail on this command, refer to The OPCON Process and Commands in the Access Integration Services Software User's Guide.) For example:
```
    * talk 5
    +
```
After you enter the talk 5 command, the GWCON prompt (+) displays on the terminal. If the prompt does not appear when you first enter configuration, press Return again.
At the + prompt, enter the f tsf command to get you to the Thin-Server> prompt.
Example:
```
    + f tsf
    Thin-Server>
```

TSF Monitoring Commands

This section describes the TSF monitoring commands.

Table 63. TSF Monitoring Command Summary

Command Function
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Delete Deletes a file from Thin Server feature file cache.
Flush Flushes the Thin Server feature file cache.
List Displays Thin Server settings and values.
Refresh Refreshes the cache.
Reset Resets counters.
Restart Restarts the Thin Server process.
Set Changes Thin Server feature settings.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Function
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Delete	Deletes a file from Thin Server feature file cache.
Flush	Flushes the Thin Server feature file cache.
List	Displays Thin Server settings and values.
Refresh	Refreshes the cache.
Reset	Resets counters.
Restart	Restarts the Thin Server process.
Set	Changes Thin Server feature settings.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

Delete

Use the delete command to remove a file from the Thin Server feature file cache.

Syntax:

delete: filename

filename

Specifies the name of the file to be remove from the file cache.

Valid Values:

Default Value: none

Example:

Thin-Server> delete
Enter filename to delete from the File Cache: /ibm/prod/ns/5494.dat
Are you sure that you want to delete this file? (Y/ [N]): y
File successfully deleted

Flush

Use the flush command to flush the TSF memory and hard disk cache space. The flush command will erase all cached files. The Thin Server cache will be updated on the next refresh from the Master Server. Network Stations may experience delays until the refresh is completed.

Syntax:

flush

Example:

Thin-Server> flush
The FLUSH command will erase all cached files.
  The Thin Server cache will be updated on the next refresh
  from the Master Server.  Network Stations may experience
  delays until the refresh is completed.
Are you sure you really want to do this? (Y/ [N]: y
All Thin Server cached files have been flushed

List

Use the list command to display TSF parameter settings.

Syntax:

list: cached-files
: config
: file-access-counters
: file-refresh-counters
: pre-load-list
: tftp-counters
: ts-counters

Example:

Thin-Server> list cached-files
 
Cached
File Name     File Size  Time Stamp         Flags  Host File Name
------------  ---------  -----------------  -----  -----------------
00000026.DAT      2729   04/08/98 13:35:07   RYY   /QIBM/ProdData/OS400/Netstat
ionRmtController/Loadlist.file
00000002.DAT   2049220   09/16/97 08:55:39   RYU   /QIBM/PRODDATA/NETWORKSTATIO
N/KERNEL
                 10060   03/04/97 16:12:44   RY-   /QIBM/PRODDATA/NETWORKSTATIO
N/FONTS/PCF/MISC/7X14B.PCF
    List is Complete

The flags have the following meaning:

WhereFrom
- R = RFS Client
- N = NFS Client
- - = None
InTable
- - = Not in Table
- u (or m) = About to Update
- Y = In the Table
FileState
- - = Not on Disk
- D = Dirty
- A = Update Aborted
- u = About to Update
- U = Update in Progress
- Y = On the Disk and Available

Common combinations of the last two flags (all three flags shown for clarity) are:

RYY - good file
RuY - full refresh in progress, this file hasn't been verified yet
RYU - this file is being updated

Example: For RFS

Thin-Server> list config
Thin Server Configuration       
    Thin Server feature mode is:                        Disconnected 
    Thin Server feature state is:                       Active, all files up-to-date
    Interval to refresh Pre-Load List (#days):          1
    Time of day (Military) to refresh Pre-Load List:    01:00:00
    Memory (KB) currently using for RAM cache:          16384
    Maximum memory (KB) configured for RAM cache:       16384
    Currently using Hard File?:                         Yes
    Hard File storage defined for Thin Server:          817664
    Hard File storage being used for Thin Server:       27328
    Number of Files Cached:                             82
    Master Server IP address:                           192.9.225.21
    Secondary Master Server IP address:                 192.9.225.20
    Master Server Retry Limit:                          10
    Master Server Selection:                            primary
    TFTP Packet Timeout Value:                          5
    TFTP Max Retries:                                   1
    TFTP Max Segment Size:                              8192
 
    Thin Server Sync Protocol:                          RFS
    Name of Pre-Load List file: 
        /QIBM/ProdData/OS400/NetstationRmtController/Loadlist.file
Thin Server>

Example: For NFS

Thin-Server> list config
 
Thin Server Configuration       
  Thin Server feature is:                          Enabled 
  Thin Server Feature state is:                    Active, initializing file structure
  Interval to refresh Pre-Load List (#days):       1
  Time of day (Military) to refresh Pre-Load List: 01:00:00
  Memory (KB) currently using for RAM cache:       25600
  Maximum memory (KB) configured for RAM cache:    25600
  Currently using Hard File?:                      Yes 
  Hard File storage defined for Thin Server:       915424
  Hard File storage being used for Thin Server:    27328
  Number of Files Cached:                          82
  Master Server IP address:                        192.9.225.21
  Secondary Master Server IP address:              192.9.225.20
  Master Server Retry Limit:                       10
  Master Server Selection:                         primary
  TFTP Packet Timeout Value:                       5
  TFTP Max Retries:                                1
  TFTP Max Segment Size:                           8192
 
  Thin Server Sync Protocol:                       NFS
  Include Directory List Follows:
 
  Include                                           
    all                                             
  Subdirs?   Directory Names                        
  --------   -----------------------------------    
     N       /usr/netstation
     Y       /usr/netstation/mods
     Y       /usr/netstation/nls
     Y       /usr/netstation/fonts
     Y       /usr/netstation/java
     Y       /usr/netstation/keyboards
     Y       /usr/netstation/proms
     Y       /usr/netstation/X11
     Y       /usr/netstation/configs
     Y       /usr/netstation/SysDef
     Y       /usr/netstation/zoneinfo
Thin Server>

Example:

Thin-Server> list file-access-counters
 
Disk Statistics/Counters:
    Number of files currently open:                20
    Number of Total File Opens:                    23
    Number of Open Fails when File is Locked:       1
    Number of Read misses - Version Mismatch:       4
    Number of Read misses - File Not Present:       3
    Number of Write misses - Hard File Full:        4

Example:

Thin-Server> list file-refresh-counters
 
File Refresh Statistics/Counters
    Last Successful refresh Master Server IP address:  192.9.225.20
    Current refresh Master Server IP address:          192.9.225.21
    Number of Files Updated during last refresh:       0
    Number of Update Failures during last refresh:     0
    Number of Refreshes:                               0
    Number of Refresh Failures:                        1
    Number of Refreshes - Primary Master Server:       0
    Number of Refresh Failures - Primary Server:       0
    Number of Refreshes - Secondary Master Server:     0
    Number of Refresh Failures - Secondary Server:     0
    Number of Files Refreshed:                         249
    Date/Time of Last File Update:                     02/17/1999 01:00:36
    Date/Time of Last File Download:                   02/16/1999 15:57:05
 
Thin Server>

Example:

Thin-Server> list pre-load-list
 <display of pre-load list raw file>
List of Pre-Load List File is Complete

Example:

Thin-Server> list tftp-counters
 
TFTP Server Statistics/Counters
    Relay to Master File Server:                             Available
    Number of Total TFTP Requests:                            3
    Number of Current TFTP Requests:                          2
    Number of Files Served:                                  22
    Number of Files Served by Master Server:                 22
    Number of Files Served by Primary Master Server:         22
    Number of Files Served by Secondary Master Server:        0
 
Thin Server>

Example: For RFS

Thin-Server> list ts-counters
 
Thin Server Statistics/Counters    
    Relay to Master File Server:                            Available
    Number of Total RFS Clients:                            0
    Number of Current RFS Clients:                          0
    Number of Files Served:                                 0
    Number of Files Served by Master Server:                0
    Number of NS Port Mapper socket accepts:                0
    Number of NS Port Mapper sockets currently active/open: 0
    Number of NS Server socket accepts:                     0
    Number of NS 8473 sockets currently active/open:        0
    Number of NS Login sock accepts:                        0
    Number of NS 8476 sockets currently active/open:        0
    Number of RFS writes to a Thin Server cached file:      0
Thin Server>

Example: For NFS

Thin-Server> list ts-counters
 
Thin Server Statistics/Counters
    Number of NFS Server Reads:                              13
    Number of NFS Server Read Directories:                    8
    Number of Unsupported NFS Requests:                       2
    Number of total NFS Mounts:                              22
    Number of current NFS Mounts:                             7
    Number of total NFS clients:                             15
    Number of current NFS Clients:                            4

Refresh

Use the refresh command to force a refresh of the cache.

Syntax:

refresh

Example:

Thin-Server> refresh
 
Force a refresh of the cache (Y/N) [N]? y
 
Thin Server cache has been refreshed

Reset

Use the reset command to dynamically reset counters.

Syntax:

reset: all
: file-access-counters
: file-refresh
: tftp-counters
: ts-counters

Example:

Thin-Server> reset all
 
All Thin Server feature counters have been reset

Restart

Use the restart command to restart the TSF process.

Syntax:

restart

Example:

Thin-Server> restart
 
Restart Thin Server? (Y/ [N]): y
 
Thin Server has been restarted

Set

Use the set command to set the TSF caching mode.

Syntax:

set: mode

mode

Specifies the mode of the TSF. See "Set".

Valid Values:

enable
disable
passthru
disconnected

Example:

Thin-Server> set mode disconnected
 
Thin Server caching is now disconnected

TSF Dynamic Reconfiguration Support

This section describes dynamic reconfiguration (DR) as it affects Talk 6 and Talk 5 commands.

CONFIG (Talk 6) Delete Interface

TSF does not support the CONFIG (Talk 6) delete interface command.

GWCON (Talk 5) Activate Interface

The GWCON (Talk 5) activate interface command is not applicable for TSF. Activating an interface does not affect the Thin Server directly; however, it may impact the connectivity to the client or master file server.

GWCON (Talk 5) Reset Interface

The GWCON (Talk 5) reset interface command is not applicable for TSF. Resetting an interface does not affect the Thin Server directly; however, it may impact the connectivity to the client or master file server.

GWCON (Talk 5) Component Reset Commands

Thin Server feature supports the following TSF-specific GWCON (Talk 5) reset commands:

GWCON, Feature TSF, Restart Command

Description:

Restarts the Thin Server.

Network Effect:

Thin client cannot access the Thin Server for files during the restart.

Limitations:

Modifying the type of master file server (rfs versus nfs) is not recommended. Doing so will affect the amount of memory available to be used as the file cache and the restart may fail if insufficient memory is available.

All TSF configuration changes are automatically activated except the following:

Commands whose changes are not activated by the GWCON, feature tsf, restart command
CONFIG, feature tsf, set memory-cache

GWCON (Talk 5) Temporary Change Commands

TSF supports the following GWCON commands that temporarily change the operational state of the device. These changes are lost whenever the device is reloaded, restarted, or you execute any dynamically reconfigurable command.

Commands
GWCON, feature tsf, set mode
Note: The mode of the thin server feature is changed.

Non-Dynamically Reconfigurable Commands

The following table describes the TSF configuration commands that cannot be dynamically changed. To activate these commands, you need to reload or restart the device.

Commands
CONFIG, feature tsf, set memory-cache
Note: If you are increasing the amount of memory cache specified, then a router restart or reload is required.

CONFIG, feature tsf, set mode
Note: If the Thin Server mode was disabled when the router was restarted or reloaded, then a router restart or reload is required after setting the Thin Server mode to enabled. The Thin Server mode defaults to disabled when the Thin Server package is initially loaded.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]